home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / emulation / atari800 / atari800.faq < prev    next >
Text File  |  1995-07-25  |  44KB  |  820 lines
  1.                                 Welcome to:
  2.                         +---------------------------+
  3.                         | The Unofficial Atari 8bit |
  4.                         |  New User, Emulator Help  |
  5.                         |            FAQ            |
  6.     Rev.0.7             |                           |            Rev.0.7
  7.                         |     By Bill Kendrick      |
  8.                         |       Revision 0.7        |
  9.                         |     January 17, 1995      |
  10.                         +---------------------------+
  11.  
  12. [ Differences from Rev.0.5: Corrected descriptions of Atari computers;
  13.   Corrected PC Xformer 3.0 dealer list; listed where Mule and Util 
  14.   can be found]
  15. [ Differences from Rev.0.6: Updated Branch Always Software information ]
  16.  
  17. PLEASE also refer to: MyDOS 4.5x documents, SIO2PC documents,
  18.   XFormer documents, and the Atari 8-bit F.A.Q.
  19.  
  20. For general help (hardware, magazines, etc.) please check the Official
  21. Atari 8-bit FAQ file:
  22.   From: Michael Current <MCURRENT@carleton.edu>
  23.   Where to get the latest copy of the Atari 8-Bit Computers 
  24.   Frequently Asked Questions List:
  25.  
  26.   ftp://rtfm.mit.edu/pub/usenet-by-group/news.answers/atari-8-bit/faq
  27.     (and many other FTP sites that archive Usenet FAQ Lists)
  28.   http://www.cis.ohio-state.edu/hypertext/faq/usenet/atari-8-bit/faq/faq.html
  29.   news:comp.sys.atari.8bit, news:comp.answers, news:news.answers
  30.  
  31.   or, send a message to mailto:mail-server@rtfm.mit.edu that says:
  32.  
  33.     send usenet/news.answers/atari-8-bit/faq
  34.     quit
  35.  
  36.   Finally, you can always ask Michael for a copy at
  37.   mailto:mcurrent@carleton.edu
  38.  
  39. Summary of Atari 8-bit's an emulated 8-bit Atari's:
  40.   
  41.   Atari 8-bit computers were produced between 1979 and 1987.  The
  42.   major models released were the:
  43.     
  44.     400 - 8K-16K, 400/800 OS, CTIA or GTIA graphics (depends when made)
  45.     800 - 8K-16K-48K, 400/800 OS, CTIA or GTIA graphics (depends when made)
  46.     1200XL - 64K, 1200XL OS, GTIA graphics
  47.     600XL - 16K, XL OS, GTIA graphics
  48.     800XL - 64K, XL OS, GTIA graphics
  49.     65XE - 64K, XL OS, GTIA graphics
  50.     130XE - 128K, XL OS, GTIA graphics
  51.     XEGS (Game System) - 64K, XEGS OS, GTIA graphics (Had Missile Command)
  52.  
  53.   All of the XL's except the 1200XL had BASIC installed on ROM.  BASIC can
  54.   be purchased on cartridge for the 400/800/1200XL's.
  55.  
  56.     Branch Always Software are the creators of:
  57.       ST Xformer (Atari 8-bit emulator for ST's), Quick ST, Quick Index,
  58.       Gemulator (Atari ST emulator for PC's), and PC Xformer (Atari 8-bit
  59.       emulator for PC's).
  60.  
  61.     ST Xformer 2.0 and 2.5 released for the Atari ST 16-bit machines.
  62.       Very limited.  Now public domain (used to be commercial).
  63.     PC Xformer 2.0 and 2.5 released for IBM PC machines.  2.0 is limited
  64.       and supports only 800 OS.  Both public domain (were always PD).
  65.     PC Xformer 3.0 released for IBM PC machines.  Supports all OSes, 320K
  66.       RAM, and best of all, player/missile collision detection (which MANY
  67.       games use!)
  68.  
  69. Graphics:
  70.   
  71.   The Atari has maximum resolution of 320 x 192 (standard, non-overscanned
  72.     screen) x 2 colors.  160 x 192 x 4, 160 x 192 x 2, 160 x 96 x 4,
  73.     160 x 96 x 2, 80 x 48 x 4, 80 x 48 x 2, 40 x 48 x 4 graphics are also
  74.     supported.  40 x 24 x 256-character (128 normal, 128 inverse, character
  75.     set indirection available) text mode is standard (2 colors).
  76.   40 x 24 x 128-multi-colored-character (4 colors per character allowed,
  77.     the other 128 characters have 4th changed into a color 5) and
  78.     40 x 12 x 128-multi-colored-character screen modes are available.
  79.   GTIA graphics support 80 x 192 x 16 shade-only, 80 x 192 x 16 hue-only,
  80.     and 80 x 192 x 9 color screen modes.
  81.   Normal (bordered), narrow (underscanned), and wide (overscanned) screen
  82.     modes are available.
  83.   Screen modes can be mixed (by lines) down the screen using the Display
  84.     List (a program which is executed by the ANTIC graphics chip every
  85.     screen refresh (60 times per second on real NTSC Ataris).
  86.   Fine scrolling (both vertical and horizontal) can be enabled on any
  87.     line on the screen.
  88.   All other screen attributes (color, player/missile horizontal position,
  89.     screen width, player/missile/playfield priority, etc.) can be ajusted
  90.     at any point down the screen via a "Display List Interrupt."
  91.   Four 8-bit wide, 128 or 256 byte high single color players, and four
  92.     2-bit wide, 128 or 256 byte high single color missiles are available.
  93.     A mode to combine the 4 missiles into a 5th 8-bit wide player is also
  94.     available, as is a mode to XOR colors or blacken out colors when players
  95.     overlap (good for making three colors out of two players!)  Players
  96.     and missiles have adjustable priority and collision detection (which
  97.     is not supported by the PC Xformer 2.0 and 2.5 and ST Xformer programs).
  98.  
  99. Sound:
  100.   
  101.   Four voices of 8-bit pitch-resolution, 4-bit volume-resolution,
  102.     8-distortion sound can be produced.  2 voices (1 and 2, and/or 3 and 4)
  103.     can be combined to make 16-bit pitch-resolution.  Also 4-bit volume-only
  104.     modes can be enabled for digitally sampled sound replay.
  105.   A fifth "voice" is produced by the internal speaker on Atari 400/800's
  106.     (for keyclick and buzzer) and in the XL's and XE's this was
  107.     (fortunately!) rerouted through the normal audio output, and the
  108.     keyclick can be disabled.
  109.  
  110. Objective of this file:
  111.      
  112.      At the time of its release (mid 1994), much discussion went on in the
  113. comp.sys.atari.8bit Usenet newsgroup about the Atari 8bit emulator for
  114. IBM / MSDOS based computers, the PC Xformer 2.0 (XF2 for short).  Many
  115. people in the 8-bit community had gotten, well, fed up with the XF2-based
  116. questions which did not pertain to them, or to the really dumb questions
  117. which were in fact understandable to new or rusty Atari 8-bit users, but
  118. had just gotten on the nerves of some of the comp.sys.atari.8bit
  119. readers/digest subscribers.
  120.      This file was created to reduce the number of 'newbie' and XF2
  121. questions.  Now it's becoming a fairly good reference (and got me the job
  122. of writing the commerical 3.0 release's documents!).
  123.      This FAQ will present answers to simple questions like "how do I turn
  124. off BASIC" (a good answer to that of course is, READ THE FRIGGIN' MANUAL)
  125. and "how do I get a disk directory?" (which is less obvious on
  126. Atari 8-bits, err.. MOST 8-bits <grin>).
  127.      It will also direct people who are unaware of the large amount of Atari
  128. 8-bit support (NOT NECESSARILY EMULATOR SUPPORT) and perhaps become a
  129. supplement for the many official and unofficial files floating around the
  130. net (like the official FAQ, the Vendor/Developer List, the Who's Who list,
  131. etc.).
  132.      Since revision 0.4 of this file, PC Xformer 2.5, a replacement for 2.0,
  133. and 3.0, the first commercial release, have been released.  It is assumed
  134. that the reader has the latest versions of PC Xformer (2.5 or 3.0), although
  135. if you have 3.0, I must say, those documents are great!  (If you don't get
  136. the joke, look at the name of the author of the manual, and look at my name.)
  137.  
  138. ---===  Xformer Questions:  ===---
  139.  
  140. Q.1) What does "READY" mean?
  141. A.1) This is the Atari BASIC prompt.  See below for hints on Atari BASIC.
  142.  
  143.  
  144. Q.2) Why doesn't this program load?
  145. A.2.1) The program may not work under the Atari 800 Operating System, it may
  146.        require the XL/XE Operating System.  Be sure you're in 800XL or 130XE
  147.        mode.  (130XE mode is only supported by XF3.0, not 2.5, but there is
  148.        no real difference in the operating systems.)
  149. A.2.2) It may not work under the XL/XE Operating System (rare cases), switch
  150.        to 800 mode.
  151. A.2.3) Be sure you turned BASIC off before trying to load it if it cannot
  152.        run with BASIC on.
  153. A.2.4) It might be a BASIC game!  Be sure you're in BASIC and use the BASIC
  154.        "RUN" or "LOAD" (and then "RUN") command.  Also, be sure it works
  155.        with the BASIC you have.  Some programs only run in BASIC XL or XE
  156.        (which are both cartridge-based BASIC's not currently supported by
  157.        the Xformer), and some run with TurboBASIC XL (disk-based).
  158. A.2.5) It may just refuse to run on the emulator.
  159.  
  160.  
  161. Q.3) How do I turn off BASIC?
  162. A.3) To toggle BASIC on and off, press [SHIFT]-[F10] ([F10] is [RESET], note:
  163.      on a real Atari 8-bit, [SHIFT]-[RESET] does not have this effect).
  164.  
  165.  
  166. Q.4) Why doesn't this game/program run correctly?
  167. A.4.1) It may use player/missle collision detection which is not supported
  168.        on the XF2.5.  You might have to shell out the $29.95 for 3.0!
  169. A.4.2) (See Question 2).
  170.  
  171.  
  172. Q.5) How do I exit XF and return to DOS?
  173. A.5) Press [F5].  Note: this does NOT temporarily 'shell' or 'jump' to MSDOS.
  174.  
  175.  
  176. Q.6) How do I get to Atari DOS?
  177. A.6.1) In BASIC, type "DOS" at the "READY" prompt.
  178. A.6.2) Reboot without BASIC on.
  179. A.6.3) Be sure you have a DOS-bootable disk image as the first MSDOS
  180.        parameter after the "XFORMER" command.  (DOS25.XFD and MYDOS45.ATR
  181.        are both DOS boot-disk-images and are both in the XF25.ZIP file or
  182.        on your XF3 disk).
  183.  
  184.  
  185. Q.7) How do I use MSDOS files with XFormer?
  186. A.7.1) Add the files to the command line and use them as their respective
  187.        drives (be sure the first drive is a DOS-bootable disk image).
  188.        Example:  XFORMER MYDOS45.ATR filename.ext
  189.        When booted the Atari will have two drives, D1: will be the MyDOS
  190.        4.50 disk image and D2: will be a write-protected disk which contains
  191.        only the file "filename.ext".  Note: there are bugs in XFormer which
  192.        make accessing files from different directories a bit hard, just use
  193.        the MOVE (or COPY and DEL) commands in MSDOS to get the file to the
  194.        directory where you call XFORMER from.
  195. A.7.2) Use the MSDOS program S2PC (S2PC.ARC available in the Utilities
  196.        directory at the UMICH archives) which allows you to access files
  197.        within a MyDOS/compatible .ATR disk image without using an SIO2PC
  198.        or the XFormer.  S2PC let's you read, write, delete, change directory,
  199.        and view the directory of a MyDOS/compatible .ATR disk image.  It
  200.        can be used via command-line parameters from MSDOS, or as a menu.
  201. A.7.3) If you can, use the MSDOS program ATARIMG, which is much like
  202.        S2PC but has a nicer, more graphical (less-menu driven) interface.
  203.        (Unfortunately, this doesn't run on all IBM's!)
  204.  
  205.  
  206. Q.8) Just what ARE .ATR and .XFD files?
  207. A.8.1) Refer to the XFormer and SIO2PC manuals for details on these files.
  208. A.8.2) Simply put, they are Atari disks, stored as files which are as big
  209.        as the disk they represent (an 88k disk image will use 88k on the
  210.        IBM).  .ATR files are used by SIO2PC (see below) as well as the
  211.        XFormer (and the S2PC program mentioned above).  .XFD files are used
  212.        by ST Xformer (the Atari 8-bit emulator for Atari ST's) and PC
  213.        Xformer (XF2,XF25,XF3).
  214.  
  215.  
  216. Q.9) What's SIO2PC?
  217. A.9.1) Refer to the XFormer and SIO2PC manuals for details on this program.
  218. A.9.2) This is a program which runs on IBM/compatibles which, with the use
  219.        of a simple (and relatively inexpensive) cable, makes the IBM act
  220.        as though it were an Atari disk drive.  (Up to four drives, actually).
  221.        It uses disk image files (.ATR's) and can also let the Atari access
  222.        single IBM files (much like XFormer does) as a single file all alone
  223.        in its own disk.  It also currently allows Print-Thru (all access to
  224.        the Atari "P:" (printer) device can be redirected to the IBM's printer,
  225.        screen, or MSDOS file; different translations/conversions are
  226.        user-defined when the Print-Thru mode is turned on).  Finally, with
  227.        the use of two programs on the Atari 8-bit (the only two programs
  228.        that currently have anything to do with SIO2PC that have been written
  229.        (to my knowledge) for the Atari 8-bit), the IBM can be controlled
  230.        remotely (commands are sent from the Atari, typing on the IBM is not
  231.        necessary) and files can be sent directly to the IBM's drives.
  232.  
  233.  
  234. Note: The following sections will simply discuss Atari BASIC, the Atari OS,
  235.       and Atari DOS 2.5 and MyDOS 4.5x (because these topics seem the most
  236.       relevant to the less-knowledged/experienced XFormer users).
  237.  
  238. ---===  Getting around on the Atari: DOS and OS ===---
  239. I. AtariDOS and MyDOS QuickReference:
  240.  
  241. MyDOS (4.50 and 4.53) presents the user with the following commands:
  242.  
  243. [*]     Disk directory of current directory (like "dir *.*" in MSDOS)
  244. [1]-[9] Disk directory of a disk drive (like "dir a:\*.*" - "dir i:\*.*")
  245. [A]     Disk directory (like "dir <mask>" and optional output destination)
  246. [B]     Quit to cartridge
  247. [C]     Copy file(s) ("<source>,<destination>" copies from one place or
  248.         disk to another, just "<source>" copies from one place on one disk
  249.         in a drive to the same place on another disk in the same drive
  250.         (asks for swapping))
  251. [D]     Delete file(s) (add "/N" to delete without being prompted first)
  252.         (add ">*.*" or ":*.*" after a subdirectory name to delete the
  253.         files within it.  A subdirectory name alone will delete the
  254.         subdirectory (if it is empty and unlocked)).  (Acts like both
  255.         "del" and "rd" in MSDOS.)
  256. [E]     Rename file(s) (renaming multiple files is allowed, but be careful).
  257.         (like "ren <old> <new>" in MSDOS - with MyDOS, use "," between
  258.         old and new masks.)
  259. [F]     Locks file(s) from overwrite, deletion and appending (like
  260.         "attrib +r <mask>" in MSDOS.)
  261. [G]     Unlocks file(s) (returns them to their default state).
  262. [H]     Writes DOS files to a disk (this creates a disk which boots with
  263.         the current version of MyDOS you are using and also has the menu
  264.         file "DUP.SYS" on it as well).  (This is like "sys"(?) in MSDOS.)
  265. [I]     Formats a disk (add "/N" after the drive number to do a quick-format
  266.         of an already-formatted disk (ie, just a very fast delete "*.*").
  267. [J]     Duplicate disk (copies an entire disk, including boot sector,
  268.         when using XFormer, it's much quicker to just copy one .XFD or .ATR
  269.         to another).
  270. [K]     Make binary file: saves memory and makes it binary-loadable.  See [L].
  271. [L]     Load binary file: loads a compiled program.  (like "<filename>" in
  272.         MSDOS, except any ".EXE", ".COM", ".OBJ", etc. is still required.)
  273. [M]     Run at address.  Mainly for advanced users.  Reboot is "E477",
  274.         reset is "E474" (these are the hex values of the addresses where
  275.         the routines to reboot and reset are.)
  276. [N]     MEM.SAV: when this is on, whenever you go to DOS (from BASIC,
  277.         for example) it will write what is in memory to a file "MEM.SAV"
  278.         so that when DUP.SYS (the menu) loads it isn't lost forever.
  279.         When you exit DUP.SYS with the "B: Run Cartridge" command, MEM.SAV
  280.         is reloaded and the environment should be as it was when you left.
  281.         It's probably quicker to simply "SAVE" your programs (if in a
  282.         language) which aren't nearly as big as all of the memory that
  283.         MEM.SAV saves.
  284. [O]     Options: this presents the user with some options.  Mainly for
  285.         advanced users or special setups.  See the MyDOS docs for details.
  286. [P]     Set density.  Forces a drive to be recognized at a certain density
  287.         if MyDOS can't figure it out. (??)
  288. [Q]     Make a subdirectory. (like "md" or "mkdir" in MSDOS).
  289. [R]     Set default directory. (like "cd" in MSDOS and "cwd" in SpartaDOS)
  290.         This makes "D:" now the same as a subdirectory or other drive.
  291.         ie, "D2:" will make all calls to "D:" act as though they are to
  292.         "D2:" instead.  Some programs when prompting for filenames do not
  293.         add "D:" to the beginning if one is not present, they add "D1:".
  294.         If you don't trust a program to look to "D:" instead of "D1:" and
  295.         you want it to look to some place OTHER than "D1:" (ie, where "D:"
  296.         is pointing which could be a VERY long path list), just add "D:"
  297.         to the beginning.  ALSO, some programs don't even ADD "D:"'s if they
  298.         aren't in the filenames you give and may give errors (138, for
  299.         example: device not present, ie, if you said "TESTFILE.DAT" it
  300.         may think you want "T:" instead of "D:TESTFILE.DAT").
  301. [S]     Set ramdisk number.  This is also under [O]ptions.
  302. [V]     Verify writes.  This is also under [O]ptions.  When Verify is on,
  303.         writes will be slower but 100% reliable.  With it off, writes will
  304.         be much faster but possibly not as reliable (on bad disks, for
  305.         example).  Default is off.
  306.  
  307. AtariDOS presents the user with the following commands which are identical
  308. to MyDOS's commands: A,B,C(no swaping),D,E,F,G,H,I(some densities),J,K,L,M,N
  309.  
  310. AtariDOS 2.5 presents the user with the following commands not present or
  311. not the same as MyDOS's commands:
  312. [O] Duplicate file.  This is used to copy a file from one disk to another
  313.     using only one drive. (In MyDOS, giving just a source will make
  314.     [C]opy act like DOS 2's Duplicate.)
  315. [P] Format Single.  In DOS 2.5, this is used to format 88k (Single Density)
  316.     disks.  To format an Enhanced Density (127k) disk, just use [I].
  317.     In DOS 2.0, [I] is the only format option and only handles 88k.
  318.     (I may be wrong, but I have never had a Double Density drive under
  319.     Atari DOS 2.0 or 2.5!)
  320.  
  321. II. General DOS and OS questions:
  322.  
  323. Q.1) How do I access the disk drives?
  324. A.1) First, you need to have booted with a DOS.  All but one DOS is on
  325.      disk (SpartaDOS X is on cartridge).  When the Atari boots up, it
  326.      does some of its 'boot-up stuff' which includes looking for a
  327.      disk drive connected and turned on which is set up as drive #1.
  328.      It then begins to load from the disk's "boot sector".  If none
  329.      exists or there's a nasty error on the disk, you get the
  330.      "BOOT ERROR" notice until the error is fixed.  (On SpartaDOS disks,
  331.      even non-bootable disks have a boot sector, but all the boot
  332.      sector is is a small program which displays a 'not a boot disk'
  333.      error).
  334.      To end the digression, the answer to 'how do I access the disk
  335.      drives' starts with 'you must boot the Atari with a DOS'.  Check
  336.      the 8-bit FAQ and the UMICH and other FTP archives for lists of
  337.      DOSes available for Ataris, but the most used are Atari DOS (for
  338.      compatibility with almost ALL older software), MyDOS (for an
  339.      Atari DOS compatible high-end DOS), and SpartaDOS (for a very
  340.      high-end DOS which looks much like MS-DOS but unfortunately
  341.      cannont run all software which runs fine with Atari DOS and
  342.      MyDOS.)  Note: SpartaDOS does NOT run on Atari 400's and 800's
  343.      (except the cartridge versions and I believe disk version 1.1).
  344.      Now that you have a DOS loaded, the Atari understands the
  345.      "D:" device (see below for Atari devices).  Since there is more
  346.      than one disk drive, you have to be able to tell them apart.
  347.      The Atari uses numbers when it has more than one of the same
  348.      device, so "D1:" is drive 1, "D2:" is drive 2, "D3:" is drive 3,
  349.      etc.!
  350.      After the "D:" device name comes the filename.  Of the most used
  351.      DOSes, only MyDOS supports lowercase letters in filenames, but
  352.      since most programs force uppercase entry for filenames, nobody
  353.      really seems to use lowercase in their filenames.
  354.  
  355.  
  356. Q.2) How do I copy things from one place to another?
  357. A.2) Atari DOS and MyDOS give you the "C" command in their menu
  358.      interface.  When it asks for a source and destination, you can
  359.      use wildcards (* and ? like in most other DOSes) to copy more
  360.      than one file at a time.  You can also present no destination
  361.      so that a file can be copied from one disk in drive 1 to another
  362.      disk in drive 1, for example, and the DOS will ask you to insert
  363.      each disk.
  364.  
  365.  
  366. Q.3) What are subdirectories?
  367. A.3) Subdirectories are places where files go which are just like the
  368.      normal directory of a disk, except the they happen to be WITHIN
  369.      that normal directory, or even another subdirectory.  For example,
  370.      you can have your disk divided up into the "GAMES" files, the
  371.      "GRAPHICS" files and the "SOUNDS" files.  A directory of the disk
  372.      (the "root" or "base" or "trunk" directory) will simply list the
  373.      three subdirectories, "GAMES", "GRAPHICS" and "SOUNDS".  Then,
  374.      if you ask for a directory listing of the "GAMES" subdirectory,
  375.      you will see the files (and perhaps other subdirectories) within
  376.      the "GAMES" directory.  Think of it as a tree.  For people familiar
  377.      with Macintoshes, "Folders" are simply subdirectories.  A window
  378.      which appears when you open a "Disk" Icon is the "root", and all
  379.      of the "Folders" within it have more windows in them which also
  380.      have file and folder icons.
  381.      Here's a comparison to using subdirectories on different DOSes
  382.                     root  'GAMES'   'SPACE' within 'GAMES'
  383.        AtariDOS      D:     n/a              n/a
  384.        MyDOS         D:   D:GAMES:     D:GAMES:SPACE:
  385.        SpartaDOS     D:   D:GAMES>     D:GAMES>SPACE>
  386.        MSDOS (IBM)   \    \GAMES\       \GAMES\SPACE\
  387.      Note, only Atari DOS would be using drive 1 here, all other DOSes
  388.      are not necessarily using drive 1, and MyDOS and SpartaDOS may
  389.      already 'be within' a subdirectory.
  390.      In MyDOS and SpartaDOS (and MSDOS), you can change the 'current'
  391.      or 'default' directory to a different place (a different drive or
  392.      a subdirectory).  "D:" can stand for "D1:" (like AtariDOS always
  393.      does) or "D2:GAMES:SPACE:"!  PLEASE READ THE MYDOS DOCUMENTS FOR
  394.      DETAILS ON THIS!
  395.  
  396.  
  397. Q.4) What does "P:", "E:", "K:", etc. mean?
  398. A.4) As stated before, the Atari has devices.  "D:" is added when a
  399.      bootable disk in drive 1 is read.  Other exist as well:
  400.        C:   cassette - readable and writeable, no filenames
  401.        D:   disk drive - readable, writeable, random access, directory,
  402.             files, multiple devices (up to 9 on MyDOS and newer SpartaDOS,
  403.             8 on AtariDOS)
  404.        E:   editior - readable, writeable.  This is how input from the
  405.             keyboard and output to the screen is normally handled.  If
  406.             you wish to type a small file up by hand and have it sent to
  407.             the printer or a file, use "E:" as the source.
  408.        G:   graphics - writeable.  This is not built into the Operating
  409.             System but must be loaded.  This is an Epson-compatible printer
  410.             driver which can easily dump graphics.
  411.        K:   keyboard - readable.  This is just the keyboard.  Input from
  412.             it is not 'echoed' back like with the "E:ditor".
  413.        M:   multi-mouse - readable, writeable?  This is not built into the
  414.             Operating System but must be loaded.  This is a handler which
  415.             runs in the background and accepts input from either a mouse,
  416.             a joystick or a touch-tablet and displays a mouse pointer on
  417.             the screen.
  418.        P:   printer - writeable.  Send data to this and it will appear
  419.             on the printer.  You can print files (documents, etc.) by
  420.             using "P:" as the destination.  The Atari XL/XE OSes support
  421.             "P1:" and "P2:", although I believe this usage is rare.
  422.        R:   RS232 - readable, writeable, concurrent mode.  This is not
  423.             built in to the Operating System, but is loaded.  It supports
  424.             modems.  The Atari 850 Interface has it's "R: handler"
  425.             'built-in', which means the Atari also looks for an 850 (or
  426.             other compatible interface) and receives the "R: handler" code
  427.             from it.  Other interfaces and the Atari 'direct-connect'
  428.             modems require a file to be loaded which contains the "R:"
  429.             code.  "R1:" and "R2:" is also supported, but also its usage
  430.             seems rare.
  431.        W:   Windowing (screens) - readable, writeable.  This is a graphics
  432.             8 graphical windowing driver (rarely used, unfortunately!).
  433.             It must of course be loaded as well.
  434.        Z:   RTime8 clock - readable, writeable.  This is also not built
  435.             in to the OS, but loaded.  This is loaded from disk and lets
  436.             the user access the "RTime8" real time, battery-backed up clock
  437.             for the Atari 8-bit.  (This is a cartridge-based device).
  438.             I am unaware of any "Z:" clone which let's you set the Atari
  439.             internal (non-real time, non-battery-backed-up) clock if you
  440.             do not have an RTime8, although I'd love to see one! <hint!!>
  441.  
  442.  
  443. Q.5) How do I print something from DOS?
  444. A.6) As stated above, just use the "C"opy command, then use the file
  445.      you wish to print as the 'source', and "P:" as the 'destination'.
  446.      Example:  "D1:DOCUMENT.TXT,P:"
  447.  
  448.  
  449. ---===  Getting around on the Atari: BASIC ===---
  450.  
  451. Q.1) What does "READY" mean?
  452. A.1) Again, this is simply the prompt that Atari BASIC (and most older
  453.      BASIC's) presents the user when it is in "Immediate" mode.
  454.      Entering a command will cause it to act immediately.
  455.      Entering a line number and then a command will place that line into
  456.      the current program.
  457.      Entering a line number alone will remove that line from the current
  458.      program.
  459.      To start a program, use the "RUN" command.
  460.      To erase a program, use the "NEW" command.
  461.      To clear variables, strings and arrays, use the "CLR" command.
  462.      To load a program, use the "LOAD" command followed by a filename
  463.      (see below).  To load and run a program, use the "RUN" command followed
  464.      by a filename.
  465.      To save a program, use the "SAVE" command followed by a filename.
  466.      To list a program, use the "LIST" command followed by an optional
  467.      start and end set of lines seperated by commas.
  468.  
  469.  
  470. Q.2) Where can I learn Atari BASIC?
  471. A.2) A (set of) file(s) will be created explaining all of Atari (and Turbo)
  472.      BASIC's commands and their usage.  (A larger file may be produced
  473.      which will be based on examples provided in the Atari BASIC Reference
  474.      Manual).  (As of Jan. 7, 1995, these particular files do not exist).
  475.  
  476.  
  477. Q.3) How do I quit BASIC?
  478. A.3.1) Type "DOS" to quit BASIC and return to DOS.
  479. A.3.2) Type "BYE" to quit BASIC and exit to the OS's "bye" routines
  480.        (Atari Memo Pad on 400/800's, Atari Rainbow on 1200XL's, and
  481.        Self Test on other XL's and XE's).  (Note: On 1200XL's, use [HELP]
  482.        to go to the Self Test when the Atari Rainbow appears).
  483. A.3.3) For XFormer users, remember, [SHIFT]+[F10] reboots and toggles BASIC.
  484.  
  485.  
  486. Q.4) Why don't strings work?
  487. A.4) Strings must be "dimensioned" like arrays in Atari BASIC.  Strings
  488.      are special character arrays.  See the BASIC usage/etc. files mentioned
  489.      in the answer to question 2.  Simply put, to make a string that will
  490.      accept up to "#" character, use  DIM <name>$(#)  .  Example:
  491.      DIM A$(10)  - now A$ can contain between 0 and 10 characters.
  492.  
  493.  
  494. Q.5) How do I make graphics?
  495. A.5) Use the "GRAPHICS" command to switch between the following screen modes:
  496.      (Note: All modes except 0, 9, 10 and 11 have four lines of 40 x 24 x 2
  497.      sized text covering the bottom of the screen.  Add "16" to the mode
  498.      number to remove this window (but do not make any PRINTs or PUTs to
  499.      the standard output otherwise a GRAPHICS 0 screen will appear))
  500.      (Note: Add "32" to the mode number to keep the screen from clearing
  501.      when it appears.  One problem, however, all screens overlay each other
  502.      so unless you only use certain modes at certain times, parts of some
  503.      screens will become (or start out) with 'garbage' on them.)
  504.      0    40 x 24 x 2 text
  505.      1    20 x 24 x 5 text
  506.      2    20 x 12 x 5 text
  507.      3    40 x 24 x 4 graphics
  508.      4    80 x 48 x 2 graphics
  509.      5    80 x 48 x 4 graphics
  510.      6   160 x 96 x 2 graphics
  511.      7   160 x 96 x 4 graphics
  512.      8   320 x 192 x 4 graphics
  513.      9    80 x 192 x 16 luminence-only graphics
  514.     10    80 x 192 x 9 graphics
  515.     11    80 x 192 x 16 hue-only graphics
  516.     12    40 x 24 x 4-colored text
  517.     13    40 x 12 x 4-colored text
  518.     14   160 x 192 x 2 graphics
  519.     15   160 x 192 x 4 graphics
  520.      Commands available in Atari BASIC for manipulating simple graphics
  521.      include:
  522.        PLOT x,y      POSITION x,y    COLOR c (c=color or character value)
  523.        DRAWTO x,y    LOCATE x,y,r  (where r is where result will be stored)
  524.        SETCOLOR c,h,l  (c=palette location, h=hue, l=lum)
  525.      Colors:
  526.        COLOR command colors are not identical to SETCOLOR command colors:
  527.          COLOR 0  will draw using the background color, set with
  528.                   SETCOLOR 4,hue,lum
  529.          COLOR 1  will draw using color "0", set with
  530.                   SETCOLOR 0,hue,lum
  531.          COLOR 2  will draw using color "1", set with
  532.                   SETCOLOR 1,hue,lum
  533.          COLOR 3  will draw using color "2", set with
  534.                   SETCOLOR 2,hue,lum
  535.         Except in GRAPHICS mode 10, where COLORs 0, 1, 2, and 3 must be
  536.           POKEd into memory locations 704, 705, 706 and 707 (the
  537.           player/missle graphics color locations).  Examples of this will
  538.           be presented in the BASIC usage files.  (Sorry)
  539.  
  540.  
  541. Q.6) How do I make sound on the Atari
  542. A.6) Remember, XFormer 2.5 doesn't support sound!  (XF3.0 does)
  543.      But anyway, in Atari BASIC:
  544.        SOUND c,p,d,v
  545.        c=channel (0-3)
  546.        p=pitch (0-255)
  547.        d=distortion (0,2,4,6,8,10,12 or 14)
  548.        v=volume (0-15)
  549.      The buzzer character is CHR$(253) aka [CONTROL]+[2] (NOT [CONTROL]+[G])
  550.  
  551.  
  552. Q.7) How do I move the cursor and edit?
  553. A.7) The Atari "E:" device (standard input/output which is the "editor")
  554.      allows the following characters for editing:
  555.  
  556.      Key:             AtASCII #:      Use:
  557.      Atari              none    Turn inverse on/off (Atari 400/800 kybds)
  558.      Inverse [Triangle] none    Turn inverse on/off (Atari XL/XE kybds)
  559.      CAPS               none    Turns caps-mode to lowercase (400/800 OS)
  560.      CAPS               none    Toggles caps-mode from upper to lower (XL/XE)
  561.      Sh-CAPS            none    Turns caps-mode to uppercase (all OSes)
  562.      Ct-CAPS            none    Turns caps-mode to [Control]-[Lock] (all)
  563.      Up ([^-])           28     Move cursor up
  564.      Down ([^=])         29     Move cursor down
  565.      Left ([^+])         30     Move cursor left
  566.      Right ([^*])        31     Move cursor right
  567.      Space               32     Move cursor right (overwrites w/Space char)
  568.      BackSpace           126    Move cursor left (deletes previous char)
  569.      Delete ([ShBkspc])  156    Deletes a (logical) line (1-3 physical lines)
  570.      Insert ([Sh>])      157    Inserts a physical line
  571.      Ct-Delete ([^Bksp]) 254    Deletes char under cursor, pulls rest left
  572.      Ct-Insert ([^>])    255    Inserts space under cursor, pushes rest right
  573.      ClearScn ([^<])     125    Clears screen
  574.      Bell ([^2])         253    Sounds buzzer
  575.      TAB                 127    Moves cursor to next TABstop
  576.      ClrTAB ([^TAB])     158    Clears any TABstop under cursor
  577.      SetTAB ([ShTAB])    159    Sets a TABstop under cursor
  578.      ESC                  27    Sets ESCape (next edit char after is shown,
  579.                                 not done, non-edit chars shown (like normal))
  580.      RETURN              155    Sends End Of Line (moves cursor to lowerleft
  581.                                 of next line, accepts input)
  582.      Note: Inverse characters have values of the normal version of the
  583.      characters plus 128.  (The only non-viewable inverse character is
  584.      inverse-ESC, or what would be the [ESC],[RETURN] combination.  The
  585.      character exists, but must be set into screen RAM by hand.  Oh well,
  586.      at least you still have 255 easily viewable characters! <grin>)
  587.  
  588.  
  589. Q.8) How do I make the editor characters appear
  590. A.8.1) As shown above, you must have an ESC sent before them.
  591.        When simply entering text, type [ESC] then the edit key and the
  592.        character for that edit key should appear.
  593.        When entering text in a PRINT statement, you must have it send an
  594.        ESC beforehand, so first type [ESC],[ESC] to make an ESCape character
  595.        appear, then type [ESC] then the edit key and the character for that
  596.        edit key should appear.  When the PRINT statement is executed, the
  597.        first ESCape (which you typed as two [ESC]'s) will make the editor
  598.        SHOW the following character (even if it is an edit character), then
  599.        the character which you entered (with [ESC] and then the edit key)
  600.        will make that character appear.  This makes it difficult to align
  601.        a set of PRINT statements which make a multi-line picture or menu
  602.        which uses viewed edit keys.  It is probably best to have all of the
  603.        lines in your program with the PRINT statements that can fit visible
  604.        on the screen, then edit them (without putting any of the ESCape
  605.        characters in, then when the picture looks like how you want it on
  606.        the screen, move the cursor to on top of each edit-key character and
  607.        press [Control]+[>] (Control-Insert).  A blank space should appear
  608.        under the cursor and the rest of the line should move right.  Now,
  609.        type [ESC],[ESC] and an ESCape edit-key character should appear
  610.        where the blank space was.  When you are finished doing that for
  611.        each line with those PRINTs in it, BE SURE TO ENTER THEM INTO THE
  612.        PROGRAM BY PRESSING [RETURN] ON EACH OF THOSE LINES!  Whew!
  613. A.8.2) Set the memory location "766" to "1" with the command "POKE 766,1"
  614.        to turn on the no-edit mode (ALL characters except End Of Lines
  615.        will appear, even ClearScreens!)  When you want to go back into
  616.        normal mode, set the location back to "0" with "POKE 766,0".
  617.  
  618.  
  619. Q.9) What's with the colors changing?
  620. A.9) THIS, MY FRIEND, IS THE FIRST EVER SCREEN SAVER!  This is called
  621.      "Attract mode" as was used on the Atari 2600 and Atari 400/800/XL/XE
  622.      series (and probably on the 5200 and 7800 but I cannot confirm this).
  623.      When a key hasn't been pressed for 7 or 9 (depending on OS, model, etc)
  624.      minutes, the screen colors begin changing, thus protecting your TV
  625.      or monitor from having a static image burned on it.
  626.      To turn this mode off, press a key, or, if within a program, use the
  627.      command "POKE 77,0" at least once every few minutes (IF the screen is
  628.      active, otherwise turning it off would be kinda useless).
  629.      To turn it on, wait 7 or 9 minutes without pressing a key or having
  630.      location "77" set to "0", or set location "77" to "128" with
  631.      "POKE 77,128", voila! instant attract mode!
  632.  
  633.  
  634. Q.10) How do I access 'devices' on the Atari?
  635. A.10) The following commands are available to Atari BASIC's (and also
  636.       variations on these are available in most other Atari languages!):
  637.       OPEN #a,b,c,d$    Opens channel 'a' for access to 'd$' in mode 'b'
  638.                         with auxillary mode 'c'.  Channel 'a' must be
  639.                         free or a 'Channel already open' (129) error
  640.                         occurs.  Examples:
  641.                           OPEN #1,4,0,"K:" - input from keyboard
  642.                           OPEN #2,8,0,"P:" - output to printer
  643.                           OPEN #3,12,0,"D:FILE" - random access to disk
  644.                           OPEN #4,9,0,"D:DATA" - append-output to disk
  645.                           OPEN #5,13,0,"R:" - concurrent to RS232 (modem)
  646.                           OPEN #6,6,0,"D:*.TXT" - directory access to disk
  647.                             (reads directory of "*.TXT" mask)
  648.       CLOSE #a          Closes channel 'a' (freeing it for use)
  649.       GET #a,b          Reads a byte from channel 'a' and stores it in 'b'
  650.       PUT #a,b          Puts byte 'b' onto channel 'a'
  651.       INPUT #a,b$       Reads a string (up to 255 bytes and a REQUIRED
  652.                         'end of line' (character 155)) from channel 'a'
  653.                         and stores it in 'b$'
  654.       INPUT #a,b        Reads a string (up to 255 bytes and a REQUIRED
  655.                         'end of line' (character 155)) from channel 'a'
  656.                         and stores the numeric value of it in 'b'
  657.       PRINT #a,<stuff>  Just like the normal BASIC PRINT statement, but
  658.                         sends the information to channel 'a' (semicolons,
  659.                         comas, and mixed types are of course allowed).
  660.       STATUS #a,b       Reads the error 'status' of channel 'a' and stores
  661.                         it in 'b'
  662.       XIO a,#b,c,d,e$   General I/O call.  This a little complicated and
  663.         may be expanded upon in a future revision.  Just be aware of the
  664.         following:
  665.           a - command
  666.           b - channel to use (usually must be free)
  667.           c - auxillary mode 1
  668.           d - auxillary mode 2
  669.           e$ - file or device to act upon
  670.         Examples:
  671.           XIO 32,#1,0,0,"D:FILE,OLDFILE" - renames file
  672.           XIO 33,#1,0,0,"D:OLDFILE" - DELETES file
  673.           XIO 34,#1,0,0,"D:GAMES" - creates a directory in My- & Sparta-DOS
  674.           XIO 35,#1,0,0,"D:NEWFILE" - locks a file from over-write and
  675.             deletion
  676.           XIO 36,#1,0,0,"D:NEWFILE" - UNlocks a locked file
  677.           XIO 40,#1,4,0,"D:PROG.OBJ" - loads and runs a binary file
  678.             (like "L" in Atari and MyDOS)
  679.           XIO 40,#1,5,0,"D:PROG.OBJ" - loads a binary file
  680.             (like "L" in Atari and MyDOS with the "/N" option)
  681.           XIO 41,#1,0,0,"D:GAMES" - changes default directory that
  682.             drive/subdirectory (all calls to "D:" will now occur within
  683.             that drive/directory)
  684.           XIO 254,#1,0,0,"D2:" - FORMAT a disk (in Atari DOS 2.5, this is
  685.             format 'enhanced', to format 'single' density, use XIO 253)
  686.             (in MyDOS, this is format, but not 'enhanced', use
  687.             XIO 253,#<channel>,1,0,"D<drive>:" for format a drive in enhanced
  688.             mode).
  689.         NOTE: 39 and 40 are the same.  Also note the useage of AUX1 in the
  690.           "XIO 40" example.
  691.  
  692.  
  693. ---===  Getting Atari files to an IBM:  ===---
  694.  
  695. Q.1) How can I read Atari disks on my IBM?
  696.  _______
  697. [ note: ] Someone please give more details or corrections here!  Thanx!
  698.  ~~~~~~~
  699. A.1.1) If you have double-density Atari disks, you can use the program
  700.        "Util" on the IBM which can read double-density Atari disks.  Please
  701.        see the Atari 8-bit FAQ for more details.
  702. A.1.2) If you have an Atari 1050 disk drive, you can use the program MULE
  703.        to copy files, one file at a time, 20k chunks at a time, from the
  704.        Atari to the IBM.  You first must format a 180k disk on your IBM,
  705.        the run MULE on your Atari to get a file onto the MULE disk, then
  706.        run MULE on the IBM to get the file onto the IBM.  Tedious, isn't
  707.        it?  MULE wasn't meant to be a fully-functional program, just a
  708.        demo to show that this was even possible.
  709. A.1.3) If you're fortunate to have a Black Box interface on your Atari,
  710.        you can get an external IBM drive and the Black Box's add-on, the
  711.        Floppy-Board and simply copy files from your Atari disks or hard
  712.        drive(s) onto IBM disks via the floppy board, then load them up
  713.        on your IBM.
  714.  
  715.  
  716. Q.2) Ok, I can't do any of that, now what?
  717. A.2.1) You can use SIO2PC, which is a program for IBM's which turns your
  718.        IBM into a set of Atari disk drives.  You need the SIO2PC cable
  719.        (which you can purchase, assembled or unassembled, or buy parts
  720.        and build it yourself) and the SIO2PC software (available at UMICH).
  721.        Connect your IBM to your Atari, load SIO2PC, and then run the
  722.        program FILE2PC on the Atari to transfer files to the IBM's hard
  723.        drive.  Or instead create a disk image within SIO2PC and copy files
  724.        from one disk (a real Atari floppy) to another (the SIO2PC image)
  725.        with the Atari or MyDOS "C"opy command.  If you want to extract files
  726.        out of the SIO2PC disk image file and store them on your IBM's hard
  727.        drive or floppies as single files, either again use FILE2PC or use
  728.        S2PC, an IBM program which can extract files from or add files to
  729.        MyDOS-compatible SIO2PC disk images!
  730. A.2.2) You can use two modems to download files from your Atari 8-bit.
  731. A.2.3) If you don't necessarily want files that you already have on your
  732.        Atari 8-bit, you can download files from the huge collection
  733.        available at FTP sites and Atari 8-bit supporting bulletin boards
  734.        and save them onto your IBM.
  735. A.2.4) If you have only one modem, so you can't connect both your Atari
  736.        8-bit and your IBM together via modems, you can do it via null-
  737.        modem, OR you can upload files from your Atari to some bulletin
  738.        board or account you have access to, and then connect the modem
  739.        to your IBM and download the files.
  740.  
  741.  
  742. Q.3) Is there any easier way to get Disk Communicator (Atari disk image)
  743.      files to and from SIO2PC disk images or PC Xformer XFD disk images
  744.      other than using Disk Communicator 3.2 on my Atari!  I mean, both files
  745.      are disk images!  They're both on my PC's hard drive!  <cry>
  746.      (AND NOTE: DiskComm. doesn't like SIO2PC a lot of the time anyway!)
  747. A.3.1) Yes!  There's a new IBM program out called DCM2DSK.
  748.        (Why "DSK" and not "ATR"?  To keep people from getting confused with
  749.        the ATR-8000(?))  The current version is '2' and it's available at
  750.        UMich's archives and probably elsewhere.  Filename: "DCM2DSK2.ZIP" in
  751.        the SIO2PC directory.
  752. A.3.2) There's also a new program which converts DCM's to XFD's.  I need to
  753.        look at it myself first before I can describe it (or someone help
  754.        me, please?)
  755.  
  756. ---===  Where to get or FTP files mentioned in this FAQ:  ===---
  757.   
  758.   The PC Xformer 2.0 and 2.5 can be downloaded from the "ftp.clark.net" FTP
  759.   site:
  760.     Directory/file-path: systems/msdos/emulators/xf25.zip (or xf2.zip)
  761.   
  762.   PC Xformer 3.0 can be purchased for $29.95 (prices may vary) from:
  763.  
  764.     U.S.A.
  765.     ======
  766.     American Technavisions  510-352-3787, fax 510-352-9227
  767.     B & C Computervisions   408-986-9960, fax 408-986-9968
  768.     Mid Cities Computers    310-867-0626, fax 310-920-8933
  769.     Rising Star Computers   800-252-2787, fax 513-254-7970
  770.     Toad Computers          800-448-8623, fax 410-544-1329
  771.  
  772.     Germany
  773.     =======
  774.     Atari Bit Byter User Club    +49 02366-39623 (same for fax)
  775.     KE-Soft                      +49 06181 87539, fax: +49 06181 83436
  776.  
  777.     United Kingdom
  778.     ==============
  779.     Micro Discount          +44 021 353 5730, +44 021 352 1669
  780.     
  781.     or directly from Branch Always Software: (USA)
  782.       14150 N.E. 20th Street, Ste 302, Belleuve, WA 98007.
  783.       1-206-369-5513, fax 1-206-885-5893
  784.       e-mail: BraSoft@aol.com
  785.   
  786.   The following programs are availabel at the "archive.umich.edu" FTP site:
  787.     SIO2PC: atari/8bit/sio2pc/*.* (all files are SIO2PC/utility files)
  788.     Mule: atari/8bit/Diskutils/mule.com (Atari), mule.exe (IBM), mule.txt
  789.     Util: atari/8bit/Utilities/myutil.zip (IBM)
  790.  
  791. AGAIN, >>> PLEASE <<< CHECK OUT THESE OTHER FILES:
  792.   ATARI 8-BIT FAQ
  793.   PC XFORMER DOCUMENTS
  794.   MYDOS DOCUMENTS
  795.   SIO2PC DOCUMENTS
  796.  
  797. Thanx!
  798.  
  799. Contacts:
  800.  
  801. I (Bill Kendrick) can be contacted at:
  802.   mailto:kendrick@vax.sonoma.edu,
  803.   or on the "comp.sys.atari.8bit" and "comp.emulators.misc" newsgroups,
  804.   or New Breed Software, 59 Palm Lane, Novato, CA 94945-2574 USA.
  805.  
  806. Darek Mihocka, the author of the PC Xformer can be contacted at:
  807.   mailto:BraSoft@aol.com
  808.   or on the "comp.sys.atari.8bit" and "comp,emulators.misc" and
  809.     other newsgroups,
  810.   or Branch Always Software, 14150 N.E. 20th Street, Ste 302, Belleuve,
  811.     WA 98007 USA.
  812.  
  813. Micheal Current, keeper of the Atari 8-bit FAQ files can be contacted at:
  814.   mailto:mcurrent@carleton.edu,
  815.   or on the "comp.sys.atari.8bit" newsgroup.
  816.  
  817. PLEASE add questions and report any mistakes or bugs to me ASAP.
  818.  
  819. -bill
  820.